This function compares two matrices of the data type ARRAY[*,*] of LREAL of equal size.
If both matrices are identical, the return value of the function is set to TRUE.
| LGF_MatrixCompare (FC) | ||||||||
|---|---|---|---|---|---|---|---|---|
| Ret_Val | Bool | |||||||
| error | Bool | |||||||
| status | Word | |||||||
| Array[*, *] of LReal | matrix1 | Array[*, *] of LReal | ||||||
| Array[*, *] of LReal | matrix2 | Array[*, *] of LReal | ||||||
| Identifier | Data type | Description |
|---|---|---|
| Ret_Val | Bool | TRUE: Both matrices are identical. |
| error | Bool | FALSE: No error TRUE: An error occurred during the execution of the FB |
| status | Word | 16#0000-16#7FFF: Status of the FB 16#8000-16#FFFF: Error identification (see following Table) |
| Identifier | Data type | Description |
|---|---|---|
| matrix1 | Array[*, *] of LReal | First Matrix |
| matrix2 | Array[*, *] of LReal | Second Matrix |
| Code / Value | Identifier / Description |
|---|---|
| 16#0000 | STATUS_NO_ERROR Execution finished without errors |
| 16#8200 | ERR_MATR1_LOWBOUND_ROWS_MATR2_LOWBOUND_ROWS Error: Matrix1 lower bound rows(Dim1) size is different with Matrix2 lower bound rows(Dim1) |
| 16#8201 | ERR_MATR1_LOWBOUND_COLUMNS_MATR2_LOWBOUND_COLUMNS Error: Matrix1 lower bound columns(Dim2) size is different with Matrix 2 lower bound columns(Dim2) |
| 16#8202 | ERR_MATR1_UPPBOUND_ROWS_MATR2_UPPBOUND_ROWS Error: Matrix1 upper bound rows(Dim1) size is different with Matrix2 upper bound rows(Dim1) |
| 16#8203 | ERR_MATR1_UPPBOUND_COLUMNS_MATR2_UPPBOUND_COLUMNS Error: Matrix1 upper bound columns(Dim2) size is different with Matrix2 upper bound columns(Dim2) |
| Version & Date | Change description | |
|---|---|---|
| 01.00.00 | Simatic Systems Support | |
| 13.11.2019 | First release | |
| 03.00.00 | Simatic Systems Support | |
| 23.04.2020 | Set version to V3.0.0, harmonize the version of the whole library | |
| 03.00.01 | Simatic Systems Support | |
| 02.02.2020 | Insert documentation | |